.TH std::raise 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::raise \- std::raise

.SH Synopsis
   Defined in header <csignal>
   int raise( int sig );

   Sends signal sig to the program. The signal handler (specified using the
   std::signal() function) is invoked.

   If the user-defined signal handling strategy is not set using std::signal() yet, it
   is implementation-defined whether the signal will be ignored or default handler will
   be invoked.

.SH Parameters

         the signal to be sent. It can be an implementation-defined value or one of the
         following values:

         SIGABRT
   sig - SIGFPE
         SIGILL  defines signal types
         SIGINT  (macro constant)
         SIGSEGV
         SIGTERM

.SH Return value

   0 upon success, non-zero value on failure.

.SH Example


// Run this code

 #include <csignal>
 #include <iostream>

 void signal_handler(int signal)
 {
     std::cout << "Received signal " << signal << '\\n';
 }

 int main()
 {
     // Install a signal handler
     std::signal(SIGTERM, signal_handler);

     std::cout << "Sending signal " << SIGTERM << '\\n';
     std::raise(SIGTERM);
 }

.SH Possible output:

 Sending signal 15
 Received signal 15

.SH See also

   signal sets a signal handler for particular signal
          \fI(function)\fP
   C documentation for
   raise
